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用 Jersey 构 建 RESTful 服 务 


作者 : waylau 
来 源 : RestDemo 


Fl Jersey) RESTful 4 1--HelloWorld 


一 、 环 境 


1. Eclipse Juno R2 

2. Tomcat 7 

3. Jersey 2.x( 最 新 2.11 版 本 测试 通过 ) 下 载 地 址 ( 
https://jersey.java.net/download.html ) 


二 、 流 程 


1. Eclipse 中 创建 一 个 Dynamic Web Project ,本 例 为 “<RestDemo” 


2. 按 个 各 人 习惯 建 好 包 ， 本 例 为 “com.waylau.rest.resources” 


4 & RestDemo 
Æ JAX-WS Web Services 
‘ag Deployment Descriptor: RestDemo 
4 28 Java Resources 
4 Æ src 


Æ com.waylau.rest.resources | 





一 一 sam cos ds om moo e 


3. 解压 jaxrs-ri-2.7， 将 api、ext、lib 文 件 夹 下 的 jar 包 都 放 到 项 目的 lib 下 ; 


> 本 地 磁盘 (Fò » [REST] » jaxrs-ri-2.7 » jaxrs-ri > 





! LAT) 帮助 (H) 
共享 了 新 建文 件 夫 

SFR 修改 日 期 
2014/3/12 1& 
2014/3/12 1€ 
2014/3/12 1€ 

|| Jersey-LICENSE 2014/3/12 1€ 

_] third-party-license-readme 2014/3/12 1€ 


项 目 引 入 jar 包 


4 (> WebContent 
> (> META-INF 
4 (> WEB-INF 
4 (> lib 

á| aopalliance-repackaged-2.2.0.jar 
4| asm-all-repackaged-2.2.0.jar 
at hk2-api-2.2.0.jar 
at hk2-locator-2.2.0.jar 
at hk2-utils-2.2.0 jar 
| javassist-3.18.1-GAjar 
af javax.annotation-api-1.2.jar 
à) javax.inject-2.2.0.jar 


af javax.servlet-api-3.0.1jar 


E 


Be) Javaxaws.rs-api-2.0.jar 

ae) Jaxb-api-2.2.7 Jar 

ae) Jersey-clientjar 

ak jersey-common.jar 

ae) Jersey-container-servletjar 

ae) jersey-container-servlet-core.jar 
ae) Jersey-guava-2.7 jar 

af jersey-serverjar 

we) org.osgi.core-4.2.0.jar 


af osgi-resource-locator-1.0.1.jar 


ae) persistence-api-1.0jar 





á| validation-api-1.1.0.Final.jar 





4. resources & F #— ^-class"HelloResource" 


package com.waylau.rest.resources; 
import javax.ws.rs.GET; 
import javax.ws.rs.Path; 
import javax.ws.rs.Produces; 
import javax.ws.rs.PathParam; 
import javax.ws.rs.core.MediaType; 
QPath("/hello") 
public class HelloResource { 
QGET QProduces(MediaType.TEXT PLAIN) 
public String sayHello() { 
return "Hello World!" 
} 


QGET @Path("/{param}") 

QProduces("text/plain;charset-UTF-8") 

public String sayHelloToUTF8(QPathParam("param") Strinc 
return "Hello " + username; 

} 








5. 


修改 web.xml, 添 加 基于 Servlet- 的 部 署 


«servlet» 


<servlet-name>Way REST Service</servlet-name> <servlet-clas 


<init -param> 


<param-name>jersey.config.server.provider .packages</param-r 
<param-value>com.waylau.rest.resources</param-value> </init 


<load-on-startup>1</load-on-startup> 
</servlet> 


<servlet -mapping> 
<servlet-name>Way REST Service</servlet-name> 
<url-pattern>/rest/*</url-pattern> 

</servlet -mapping> 


|) [mr __# 





. REA SR I tomcat, 4 4T 


. 浏览 器 输入 要 访问 的 uri 地 址 http://localhost:8089/RestDemo/rest/hello, à H 


Hello World! 


P 
uray © http://localhost:8089/RestDemo/rest/hello 


@ localhost 











Hello World! 





http://localhost:8089/RestDemo/rest/hello/Way%E4%BD%A0%E5%A5%BD 
%E5%90%97, H Hello Way 你 好 吗 





(- > le http://localhost:S089/RestDemo/rest/hello/WAy4 4 n3 








@ localhost 





Hello Wav 你 好 吗 


参考 : https:;//jersey.java.net/documentation/latest/user-guide.html 


本 章 源码 : https://github.com/waylau/RestDemo/tree/master/jersey-demot1- 
helloworld 


用 Jersey 构 建 RESTful 服 务 2--JAVA 对 象 转 成 XML 
输出 


一 、 总 体 说 明 


XML 和 JSON 是 最 为 常用 的 数据 交换 格式 。 本 例子 演示 如 何 将 java 对 象 ， 转 成 XML 
输出 。 


二 、 流 程 


1. 在 上 文 的 例子 中 ， 创 建 一 个 包 “com.waylau.rest.bean” 
2. 在 该 包 下 创建 一 个 JAVA 类 "User" 


package com.waylau.rest.bean; 
import javax.xml.bind.annotation.XmlRootElement; 
JE 
* HF bean 
* @author waylau.com 
* 2014-3-17 
ie 
@XmlRootElement 
public class User { 


private String userId; 
private String userName; 
private String age; 


public User() {}; 


public User(String userId, String userName, String age) 
this.userId - userId; 
this.userName - userName; 
this.age - age; 
} 
public String getUserId() { 
return userId; 


public void setUserId(String userId) ( 
this.userId - userId; 
} 


public String getUserName() { 
return userName; 


public void setUserName(String userName) { 
this.userName = userName; 
j 


public String getAge() { 
return age; 


public void setAge(String age) ( 
this.age - age; 





注意 : 该 类 上 面 增加 了 一 个 注解 "@XmlIRootElement"， 在 将 该 类 转化 成 XML 
时 ， 说 明 这 个 是 XML 的 根 节点 。 


3. 在 “com.waylau.rest.resources” 中 ， 增 加 资源 "UserResource“， 代 码 如 下 : 


package com.waylau.rest.resources; 


import java.util.ArrayList; 
import java.util.HashMap; 


import 
import 


import 
import 
import 
import 
import 
import 
import 
import 


import 


java.util.List; 
java.util.Map; 


javax.ws.rs.Path; 
javax.ws.rs.Produces; 
javax.ws.rs.PathParam; 
javax.ws.rs.core.MediaType; 
javax.ws.rs.DELETE; 
javax.ws.rs.GET; 
javax.ws.rs.POST; 


javax.ws.rs.PUT; 


com.waylau.rest.bean.User; 


QPath("/users") 


public 


class UserResource ( 


private static Map<String,User> userMap = new HashMap<£ 
VASE 


* 


查询 所 有 


* @return 


A 


QGET 
QProduces(MediaType.APPLICATION XML) 
public List«User» getAllUsers(){ 


j 


List«User» users = new ArrayList<User>(); 
User u1 = new User("001", "WayLau", "26"); 
User u2 new User("002", "King", "23"); 
User u3 new User("003", "Susan", "21"); 


userMap.put(u1.getUserId(), u1); 
userMap.put(u2.getUserId(), u2); 
userMap.put(u3.getUserId(), u3); 


users.addAll( userMap.values() ); 
return users; 


QGET 
@Path("/getUserXml") 
@Produces(MediaType.APPLICATION XML) 
public User getUserXml() { 
User user = new User); 
user.setAge("21"); 
user.setUserId("004"); 
user.setUserName( "Amand" ) ; 
return user; 








# + MediaType.APPLICATION. XML 说 明了 是 以 XML 形式 输出 


用 Jersey 构 建 RESTful 服 务 


Q, 


在 浏览 器 输入 http://localhost:8089/RestDemo/rest/users/getUserXml， 输 出 单 
个 对 象 


ET qi srOücerimi TMCIOSCIDInIEernEREXOIOTE! 





ZO BE FEM KEA IAD TR) 


HOD) E ttp://localhost:8089/RestDemo/rest/users/getUserXmll 





<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> 
- <user> 
<age>21</age> 
«userId» 004 «/userId» 
«userName» Amand «/userName» 
</user> 


在 浏览 器 输入 http://localhost:8089/RestDemo/rest/users 输出 对 象 的 集合 





interne B Exnigi 


IAQ FH 


Stem! 


RHO REO SEV RRA 








地 址 (D) | Æ] http://localhost:8089/RestDemo/rest/users| 





<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> 
- <users> 
- <user> 
<age>26</age> 
«userId» 001 «/userId» 
<userName>WayLau</userName> 
</user> 
- <user> 
<age>23</age> 
«userId» 002 «/userId» 
«userName» King « /userName» 
</user> 
- <user> 
<age>21</age> 
«userId» 003 «/userId» 
«userName» Susan «/userName» 
«/user» 
«/users» 


本 章 源 码 : https://github.com/waylau/RestDemo/tree/master/jersey-demo2-xml 
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用 Jersey 构 建 RESTful 服 务 3--JAVA 对 象 转 成 JSON 
输出 


一 、 总 体 说 明 


XML 和 JSON 是 最 为 常用 的 数据 交换 格式 。 本 例子 演示 如 何 将 java 对 象 ， 转 成 
JSON 输 出 。 


二 、 流 程 


1. 在 上 文 项 目 中 ， 在 “com.waylau.rest.resources.UserResource“ 中 增加 代码 ， 
代码 如 下 : 


QGET 
QPath("/getUserJson") 
QProduces(MediaType.APPLICATION JSON) 
public User getUserJson() { 
User user - new User(); 
user.setAge( "27"); 
user.setUserId("005"); 
user.setUserName("Fmand"); 
return user; 


MediaType.APPLICATION_JSON 说 明 输 出 的 是 JSON 格 式 


2. 运行 项 目 ， 浏 览 器 输 
Ahttp://localhost:8089/RestDemo/rest/users/getUserJson 期 望 获取 到 json 的 
数据 ， 此 时 ， 项 目 报错 


org.glassfish. 
org. 


at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 


org 


org. 


org 


org. 
org. 
org. 
org. 
org. 
org. 


org 


org. 


org 


jersey.message.internal.MessageBodyProviderNotFc 


glassfish. 
.glassfish. 
glassfish. 
.glassfish. 
glassfish. 
glassfish. 
glassfish. 
glassfish. 
glassfish. 
glassfish. 
.glassfish. 
glassfish. 
.glassfish. 


KÐ MAD xq ZRA IAD Ebt 
IRE Æ) htgo//localho:t&089/RestDemo/rest/usen/getUsericon. 


HTTP Status 500 - 


jersey. 
jersey. 
jersey. 
jersey. 
jersey. 
jersey. 
jersey. 
jersey. 
jersey. 
jersey. 
jersey. 
jersey. 
jersey. 


TPM Ins saver encountered an intemal error that merentad & fram fulana this request 


EEE 


javax.servlet.ServletException: 
fish.jersey. 
org.glassfish.jersey. 
org.glassfish.jersey 
org.glassfish.jersey. 


org.glass 


org.apache. 


此 时 ， 需 要 获取 json 转 换 包 的 支持 。 可 以 由 多 种 方式 实现 : 


org.glassfish.jersey.mess 


servlet.ServletContainer. 


.servlet.ServletContainer. 


servlet.ServletContainer. 
tomcat.websocket.server.WsFilter.doFilter (WsFilter.java:52) 





service (ServletContainer.java: 
service (ServletContainer. java: 
service (ServletContainer.java: 


message.internal.WriterIntercer 
message.internal.WriterIntercer 
filter.LoggingFilter.aroundwrit 
message.internal.WriterIntercer 
server.internal.JsonWithPaddinc 
message.internal.WriterIntercer 
server.internal.MappableExcepti 
message.internal.WriterIntercer 
message.internal.MessageBodyFac 
server.ServerRuntime$Responder. 
server.ServerRuntime$Responder. 
server.ServerRuntime$Responder. 
server.ServerRuntime$1.run(Serv 





age.internal.MessageBodyProvide 
servlet.WebComponent.service (WebComponent.java:392) 


381) 
344) 
219) 


MOXy ` JSON- 


P ` Jackson ` Jettison # » 445] A Jackson ° 


3. jackson-all-1.9.11.jar TÅ 35 3Ehttp://wiki.fasterxml.com/JacksonDownload 


项 目 中 引入 jackson-all-1.9.11.jar 


5. 在 “com.waylau.rest" 目 录 下 创建 RestApplication.java 


package com.waylau.rest; 


import org.codehaus. jackson. jaxrs.JacksonJsonProvider ; 
import org.glassfish.jersey.filter.LoggingFilter; 
import org.glassfish.jersey.server.ResourceConf ig; 


VASE 
* 应 用 
* @author waylau.com 
* 2014-3-18 
T 


public class RestApplication extends ResourceConfig { 
public RestApplication() { 


// 服 务 类 所 在 的 包 路 径 
packages("com.waylau.rest.resources"); 
// i&kWt JSON£ À & 
register(JacksonJsonProvider.class); 


6. 修改 web.xml， 初 始 化 从 RestApplicaton 进 入 应 用 ， 如 下 : 


<servlet> 
<servlet-name>Way REST Service</servlet -name> 
<servlet-class>org.glassfish.jersey.servlet.ServletContair 
<init -param> 
<param-name>javax.ws.rs.Application</param-name> 
<param-value>com.waylau.rest.RestApplication</param- 
</init -param> 


<load-on-startup>1</load-on-startup> 
</servlet> 


«servlet-mapping» 
<servlet-name>Way REST Service</servlet-name> 
<url-pattern>/rest/*</url-pattern> 

</servlet -mapping> 


LE, 


7. 4TH B > FEX Phttp://localhost:8089/RestDemo/rest/users/getUserJson 
即 可 输出 JSON 文 本 





Fl Jersey Æ RESTfuUIR 4 








WERE E Google [> 有 道 网 页 翻译 20 © PortableApps.com ` 


{'userld":"005", “userName”: “Fmand", “age”: "27"} 


本 章 源码 : https://github.com/waylau/RestDemo/tree/master/jersey-demo3-json 
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14 


H Jersey} Æ RESTfuUR 2-4--i$ 3t jersey-client 3 
P 3% TA A Jersey 5 Web/R $ 1€ CURD 


一 、 总 体 说 明 


通过 jersey-client 接 口 ， 创 建 客户 端 程序 ， 来 调用 Jersey 实 现 的 RESTful 服 务 > 实现 
增 、 删 、 改 、 查 等 操作 。 服务 端 主 要 是 通过 内 存 的 方式 ， 来 模拟 用 户 的 增加 、 删 
除 、 人 修改、 查询 等 操作 。 


— 
— 


` 创建 服务 端 


1. 在 上 文 项 目 中 ， 在 “com.waylau.rest.resources.UserResource“ 中 修改 代码 ， 


2. 


一 个 HashMap， 用 来 保存 添加 的 用 户 


private static Map<String,User> userMap = new HashMap<String,L 


F o 





创建 增 、 删 、 改 、 查 用 户 资源 等 操作 


* 增加 
* @param user 
E 
QPOST 
QConsumes ([MediaType.APPLICATION XML, MediaType.APPLICATION 
public void createStudent(User user) ( 
userMap.put(user.getUserId(), user ); 
} 


EXER 
* 删除 
* @param id 
= 
QDELETE 
@Path("{id}") 
public void deleteStudent(QPathParam("id")String id){ 
userMap.remove(id); 
J 


[Pros 
* 修改 
* @param user 
“7 

@PUT 


@Consumes (MediaType.APPLICATION XML) 
public void updateStudent(User user)( 
userMap.put(user.getUserId(), user ); 


j 


// 9383 
* 根据 id 查询 
* @param id 
* @return 
By 


QGET 
@Path("{id}") 
@Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION 
public User getUserById(@PathParam("id") String id){ 
userMap.get(id); 


} 


[Pers 


User u 
return u; 


* 查询 所 有 


* @return 


TA 


QGET 
QProduces((MediaType.APPLICATION XML, MediaType.APPLICATION 
public List<User> getAllUsers(){ 

List<User> users = new ArrayList<User>( ); 

users.addAll( userMap.values() ); 

return users; 





三 、 创 建 客户 端 程序 


创建 包 “com.waylau.rest.client*， 在 包 下 建 一 个 UserClient.jjava， 代 码 如 下 : 


package com.waylau. 


import 
import 
import 
import 
import 
import 


import 
import 


[ee 


javax 
javax 
javax 
javax 


javax 
javax 


WS. 
WS. 
WS. 
WS. 
WS. 
WS. 


rest.client; 


rs 
rs 
rs 
rs 
rs 
rs 


.client.Client; 
.client.ClientBuilder; 
.Client.Entity; 
.client.WebTarget; 
.core.MediaType; 
.core.Response; 


org.codehaus. jackson. jaxrs.JacksonJsonProvider; 


com.waylau.rest.bean.User; 


* 用 户 客户 端 ， 用 来 测试 资源 


* @author waylau.com 
* 2014-3-18 
2 
public class UserClient { 


private static String serverUri = "http://localhost :8089/R« 
VENE 
* (param args 
Ay 
public static void main(String[] args) { 
addUser( ); 
getAllusers(); 
updateUser(); 
getUserById(); 
getAllUsers(); 
delUser(); 
getAllusers(); 


} 
SES 
* 添加 用 户 
ur 
private static void addUser() { 
System.out.println("****2$7«Jl] P addUser****"); 
User user = new User("006", "Susan", 21"); 
Client client - ClientBuilder.newClient(); 
WebTarget target = client.target(serverUri + "/users" 
Response response - target.request().buildPost(Entity 
response.close(); 


j 


JESS 
* ARAP 

private static void delUser() { 
System.out.println("**** 删 除 用 户 ****")， 
Client client = ClientBuilder.newClient(); 
WebTarget target = client.target(serverUri + "/users/( 
Response response - target.request().delete(); 
response.close(); 


j 


y uiia 
* 修改 用 户 

private static void updateUser() { 
System.out.println("****/£zX fl P updateUser****"); 
User user = new User("006", "Susan", ' 33"); 
Client client - ClientBuilder.newClient(); 
WebTarget target = client.target(serverUri + "/users" 
Response response - target.request().buildPut( Entity 
response.close(); 


ASE 
* 根据 Id 查询 用 户 
Dus 
private static void getUserById() { 
System.out.println("**** 根 据 id 查 询 用 户 ****")， 
Client client = ClientBuilder.newClient().register(Ja« 
WebTarget target = client.target(serverUri + "/users/( 
Response response - target.request().get(); 
User user - response.readEntity(User.class); 
System.out.println(user.getUserId() + user.getUserName 
response.close(); 
} 
ASS 
* 查询 所 有 用 户 
a7 
private static void getAllUsers() { 
System.out.println("****&igPtZ getAllUsers****"); 


Client client - ClientBuilder.newClient(); 


WebTarget target = client.target(serverUri + "/users" 
Response response - target.request().get(); 

String value - response.readEntity(String.class); 
System.out.println(value); 

response.close(); // 关 闭 连接 





启动 服务 端 项 目 ， 运 行 客户 端 程序 UserClient， 控 制 台 输出 如 下 


**** 增 加 用 户 addUser**** 

**** 查 询 所 有 getAllUserS**** 

[{"userId":"006", "userName":"Susan", "age" :"21"3] 
****4? HP updateUser**** 

mcs nequid 

006Susan33 

**** 4-9 PF A getAllUsers**** 

[{"userId": "006", userName" :"Susan", age" :" 33" 3] 
x kx xh) pA J] P xxx 

*x* * #4 PTA getAllUsers**** 

[] 


x? 
Ao EE 


1. 客户 端 如 果 需 要 进行 JSON 转 换 ， 需 要 进行 JSON 注 册 


Client client = ClientBuilder.newClient().register(JacksonJsonF 


3d _ — 








2. WebTarget 指明 了 要 请 求 的 资源 的 地 址 
3. target.request(). 后 面 跟 的 是 请 求 的 方法 :POST，GET，PUT 或 DELETE 


本 章 源码 : https://github.com/waylau/RestDemo/tree/master/jersey-demo4-client- 
curd 


HF Jersey74 Æ RESTfuUR 5 5-- 
Jersey* MySQL 5.6-*Hibernate4.3 


— 总 体 说 明 


本 例 运 行 演示 了 用 Jersey 构 建 RESTful 服 务 中 ， 如 何 同 过 Hibernate 将 数据 持久 化 进 
MySQL 的 过 程 


二 、 环 境 


1. 上 文 的 项 目 RestDemo 


2. MySQL5.6 下 载 http://dev.mysql.com/get/Downloads/MySQL-5.6/mysql-5.6.16- 
win32.zip 


3. Hibernate4.3.4 T 
a http://sourceforge.net/projects/hibernate/files/hibernate4/4.3.4.Final/hiberna 
te-release-4.3.4.Final.zip 


4. Java 3& # MySQL 49 38 4 mysql-connector-java-5.1.29-bin.jar F À 
http://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java- 
5.129.zip 


三 、 数 据 库 准 备 
1. 搭建 MySQL 数 据 库 
2. 创建 数据 库 RestDemo ,及 数据 表 t_usen 结 构 如 下 


DROP TABLE IF EXISTS 't user `, 
CREATE TABLE ^t user” ( 
"userId' varchar(50) NOT NULL, 
^userName^ varchar(50) NOT NULL, 
‘age varchar(50) NOT NULL, 
PRIMARY KEY ( userId ) 
) ENGINE-InnoDB DEFAULT CHARSET=utf8; 


Fl Jersey44 Æ RESTfuUR + 





Gwe bises uses | Bank Saree amer | Pr? tis + 78 
ti jes [|^ — | atas [ER lim [som] 
E] «m 小数点。 TTE 
varchar 50 0 
varchar so 0 














varchar so 0 














PS: userld 非 自 增长 类 型 ， 需 要 在 业务 添加 


四 、3 引 入 Hibernate 


1. 解压 Hibernate 的 包 ， 在 lib\required 文 件 夹 下 所 有 jar 引 入 进项 目 


Le Ff "Lee LJ 


\hibernate-release-4.3.4.Final\hibernate-release-4.3 4.Final\lib\required — 
名 称 ^ 大 小 ”类 型 修改 日 期 








[fantir-2.7.7.jar | 435 KB JAR ICRF 2014-1-8 17:23 
Fe 307 KB JAR 文 件 2014-1-8 17:15 
5) hibernate-commons-annot... 74 KB JAR SURF 2014-1-8 17:23 
3) hibernate-core-4.3.4,Final.jar 5,102 KB JAR 文 件 2014-3-3 10:26 

hibernate-jpa-2.1-api-1.0.0.... 111 KB JAR ICH 2014-1-8 17:23 
£3) jandex-1.1.0.Final.jar 75 KB JAR SCPE 2014-1-8 17:23 
ij javassist-3.18.1-GA jar 698KB JARI 2014-1-8 17:15 

jboss-logging-3.1.3.GA jar 56KB JAR ICH 2014-1-8 17:22 
31 jboss-logging-annotations-... 12 KB JAR 3CPF 2014-1-8 17:22 
f] jboss-transaction-api_1.2_s... 28 KB JR 文件 2014-1-8 17:23 


2. f#mysql-connector-java-5.1.29.zip > #mysql-connector-java-5.1.29-bin.jar 
引入 进项 目 


3. 在 项 目的 根 目录 创建 hibernate 的 配置 文件 hibernate.cfg.xml， 内 容 如 下 : 
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<?xml version='1.0' encoding-'utf-8'?» 

<!DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-configuration-: 


<hibernate-configuration> 
<session-factory> 


<!-- Database connection settings --> 
<property name="connection.driver_class">com.mysql. jdbc 
«property name="connection.url">jdbc:mysql://127.0.0.1: 
«property name="connection.username">root</property> 
«property name="connection.password"></property> 
<!-- JDBC connection pool (use the built-in) --> 
«property name="connection.pool_size">1</property> 


<!-- SQL dialect --> 


<property 


name="dialect">org.hibernate.dialect .MySQLDié 


<!-- Enable Hibernate's automatic session context manac 


<property 


name="Current_session_context_class">thread</ 


<!-- Disable the second-level cache --> 


<property 


<!-- Echo 
<property 


<!-- Drop 
<property 


name="cache.provider_class">org.hibernate.cac 


all executed SQL to stdout --> 
name="Show_sql">true</property> 


and re-create the database schema on startup 
name="hbm2dd1.auto">update</property> 


«mapping resource="com/waylau/rest/bean/User.hbm. xm1"/> 


</session-factory> 
</hibernate-configuration> 


sss ë 





4. 在 项 目 User.java 的 同 个 目录 下 ， 创 建 该 类 的 映射 文件 Userhbm.xml 


<?xml version="1.0"?> 

<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtc 


«hibernate-mapping package="com.waylau.rest.bean"> 


«class name="User" table="T_USER"> 
«id name="userId" column="USERID" type="string" > 
<generator class="assigned"/> 
</id> 
«property name="userName" type="string" /> 
«property name="age" type="string" /> 
</class> 


</hibernate-mapping> 
ml 一 一 一 


. 创建 包 com.waylau.rest.util， 在 该 包 下 创建 HibernateUtil.java 





package com.waylau.rest.util; 


import org.hibernate.SessionFactory; 
import org.hibernate.boot.registry.StandardServiceRegistry; 
import org.hibernate.boot.registry.StandardServiceRegistryBuilc 
import org.hibernate.cfg.Configuration; 
AES 
* Hibernate 初始 化 配置 工具 类 
* @author waylau.com 
* 2014-3-23 
= 
public class HibernateUtil { 
private static Configuration configuration, 
private static SessionFactory sessionFactory; 
private static StandardServiceRegistry standardServiceRegi 
static { 
try í 
// 第 一 步 : 读 取 Hibernate 的 配置 文件 hibernamte.cfg.xml3 
configuration = new Configuration().configure("hi 
// 第 二 步 :创建 服务 注册 构建 器 对 象 ， 通 过 配置 对 象 中 加 载 所 有 的 配 
StandardServiceRegistryBuilder sb = new Standards 
sb.applySettings(configuration.getProperties()); 
// 创 建 注册 服务 
standardServiceRegistry = sb.build(); 
// 第 三 步 :创建 会 话 工厂 
sessionFactory = configuration.buildSessionFactor 
} catch (Throwable ex) { 
// Make sure you log the exception, as it might 
System.err.println("Initial SessionFactory cree 
throw new ExceptionInInitializerError(ex); 


j 


public static SessionFactory getSessionFactory() ( 
return sessionFactory; 





6. 在 项 目 中 建 com.waylau.rest.dao 包 ， 在 该 包 下 建立 User 操 作 的 接口 
UserDao.java 


package com.waylau.rest.dao; 
import java.util.List; 
import com.waylau.rest.bean.User; 


VASE 
* User Dao 接口 
* (author waylau.com 
* 2014-3-18 
Æ, 
public interface UserDao ( 


public User getUserById(String id); 
public boolean deleteUserById(String id); 
public boolean createUser(User user); 
public boolean updateUser(User user); 


public List«User» getAllUsers(); 


7. 在 项 目 中 建 com.waylau.rest.dao.impl 包 ， 在 该 包 下 建立 User 操 作 接 口 的 实现 
UserDaolmpl.java 


package com.waylau.rest.dao.impl; 
import java.util.List; 


import org.hibernate.Query; 

import org.hibernate.Session; 

import org.hibernate.SessionFactory; 
import org.hibernate.Transaction; 


import com.waylau.rest.bean.User; 
import com.waylau.rest.dao.UserDao; 
import com.waylau.rest.util.HibernateUtil; 
VERUS 
* RH P DAO S 3L 
* (author waylau.com 
* 2014-3-23 
=y 
public class UserDaoImpl implements UserDao { 


QOverride 

public User getUserById(String id) { 
SessionFactory sessionFactory - HibernateUtil.getSessic 
Session s - null; 


Transaction t - null; 
User user - null; 
tryt 
S = sessionFactory.openSession(); 
t - s.beginTransaction(); 
String hql = "from User where userId="+id; 
Query query = s.createQuery(hql); 
user - (User) query.uniqueResult(); 
t.commit(); 
jcatch(Exception err){ 
t.rollback(); 
err.printStackTrace(); 


}finally{ 
s.close(); 
} 
return user; 
} 
QOverride 


public boolean deleteUserById(String id) { 

SessionFactory sessionFactory - HibernateUtil.getSessic 
Session s - null; 
Transaction t - null; 

boolean flag - false; 

tryt 

S = sessionFactory.openSession(); 

t - s.beginTransaction(); 

User user - new User(); 
user.setUserId(id); 

s.delete(user); 

t.commit(); 

flag - true; 

}catch(Exception err){ 

t.rollback(); 
err.printStackTrace(); 


}finally{ 
s.close(); 
} 
return flag; 
} 
@Override 


public boolean createUser(User user) { 
SessionFactory sessionFactory = HibernateUtil.getSessic 
Session s = null; 
Transaction t = null; 
boolean flag = false; 
tryt 
S = sessionFactory.openSession(); 
t - s.beginTransaction(); 
s.save(user); 
t.commit(); 
flag - true; 


jcatch(Exception err){ 
t.rollback(); 
err.printStackTrace(); 


}finally{ 
s.close(); 
} 
return flag; 
} 
QOverride 


public boolean updateUser(User user) ( 
SessionFactory sessionFactory - HibernateUtil.getSessic 
Session s - null; 
Transaction t - null; 
boolean flag - false; 
try{ 
S = sessionFactory.openSession(); 
t - s.beginTransaction(); 
s.update(user); 
t.commit(); 
flag - true; 
}catch(Exception err){ 
t.rollback(); 
err.printStackTrace(); 


}finally{ 
s.close(); 
} 
return flag; 
} 
QOverride 


public List«User» getAllUsers() ( 

SessionFactory sessionFactory - HibernateUtil.getSessic 
Session s - null; 
Transaction t - null; 

List«User» uesrs - null; 

tryt 

S = sessionFactory.openSession(); 

t - s.beginTransaction(); 

String hql - "select * from t user"; 

Query query = s.createSQLQuery(hq1).addEntity(User.cle 
query.setCacheable(true); // 设置 缓存 

uesrs - query.list(); 

t.commit(); 

}catch(Exception err){ 

t.rollback(); 
err.printStackTrace(); 

}finally{ 

s.close(); 


} 


return uesrs; 








8. 修改 项 目 中 com.waylau.rest.resources & F 49 UserResource.java > 4& Z 3j Æ 
内 存 中 模拟 CURD 转 为 在 数据 库 中 实现 


package com.waylau.rest.resources; 


import 
import 


import 
import 
import 
import 
import 
import 
import 
import 
import 


import 
import 


ARES 


java.util.ArrayList; 
java.util.List; 


javax 
javax 


javax. 


javax 
javax 
javax 
javax 
javax 
javax 


WS. 
WS. 
WS. 
WS. 
WS. 
WS. 
WS. 
WS. 
WS. 


rs. 
rs. 
rs. 
.PathParam; 
rs. 
rs. 
rs. 
rs. 
rs. 


rs 


Path; 
Produces; 
Consumes; 


core.MediaType; 
DELETE; 

GET; 

POST; 

PUT; 


com.waylau.rest.bean.User; 
com.waylau.rest.dao.impl.UserDaoImpl; 


* JE P OR 
* (author waylau.com 
* 2014-3-19 


rd 


QPath("/users") 
public class UserResource { 
private UserDaoImpl userDaoImpl = new UserDaoImpl(); 


VASE 


* 


增加 


* @param user 


we 


@POST 
@Consumes({MediaType.APPLICATION_XML, MediaType.APPLICATION 
public void createUser(User user) { 
userDaoImpl.createUser (user); 


} 


jf eis 


* 


* (param id 
7 


删除 


QDELETE 
@Path("{id}") 
public void deleteUser(QPathParam("id")String id){ 
userDaoImpl.deleteUserById(id); 


} 


se 
* AER 
* @param user 
7 
@PUT 
QConsumes (MediaType.APPLICATION XML) 
public void updateUser(User user)( 
userDaoImpl.updateUser(user); 
J 


ASE 
* 根据 Id 查询 
* @param id 
* @return 
^ 
@GET 
@Path("{id}") 
@Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION 
public User getUserById(@PathParam("id") String id){ 
User u = userDaoImpl.getUserById(id); 
return u; 


} 


EXER 
* 查询 所 有 
* @return 
i À 
QGET 
QProduces((MediaType.APPLICATION XML, MediaType.APPLICATION 
public List«User» getAllUsers(){ 
List«User» users = new ArrayList<User>( ); 
users - userDaoImpl.getAllUsers(); 
return users; 





. 将 服务 端 运行 后 


2. 运行 UserClient 客 户 端 ， 可 以 看 到 数据 库 已 经 实现 增删 改 查 


— 


用 Jersey 构 建 RESTful 服 务 


本 章 源码 : 
hibernate 





xiangce:baidü:comi 


https://github.com/waylau/RestDemo/tree/master/jersey-demo5-mysq|- 


Fl Jersey#4 :£ RESTfuUR 4 5--Jersey+MySQL5.6+Hibernate4.3 30 


HF Jersey) Æ RESTfuUR 4 6-- 
Jersey+SQLServer+Hibernate4.3 
— ^ BARA 


本 例 运行 演示 了 用 Jersey 构 建 RESTful 服 务 中 ， 如 何 同 过 Hibernate 将 数据 持久 化 进 
SQLServer 的 过 程 


二 、 环 境 


1. Ex 492i À RestDemo 

2. SQLServer2005 

3. jtds 数 据 库 连接 驱动 : 下 载 地 址 最 新 版 本 ,替换 掉 上 文 项 目 中 
的 mysql-connector 


三 、 配 置 


1. 与 上 文 mysql 的 配置 不 同 点 主要 在 hibernate.cfg.xml 文 件 ; 配置 如 下 : 


<?xml version='1.0' encoding-'utf-8'?» 

<!DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"http://www.hibernate.org/dtd/hibernate-configuration-: 


<hibernate-configuration> 
<session-factory> 


<!-- Database connection settings --> 
<property name="connection.driver_class">net.sourceforc 
«property name="connection.url">jdbc:jtds:sqlserver://1 
«property name="connection.username">sa</property> 
«property name="connection.password">aA123456</property 
<property name="hibernate.default_schema">RestDemo</prc 
<!-- JDBC connection pool (use the built-in) --> 
<property name="connection.pool_size">1</property> 
<!-- SQL dialect --> 
«property name="dialect">org.hibernate.dialect .SQLServe 
<!-- Enable Hibernate's automatic session context manac 
«property name="current_session_context_class">thread</ 
<!-- Disable the second-level cache --> 
«property name="cache.provider_class">org.hibernate.cac 
<!-- Echo all executed SQL to stdout --> 
«property name="sShow_sql">true</property> 
<!-- Drop and re-create the database schema on startup 


<property 


name="hbm2dd1.auto">update</property> 


«mapping resource="com/waylau/rest/bean/User.hbm. xm1"/> 
</session-factory> 
</hibernate-configuration> 


加 二 





2. 修改 于 mysql| 不 兼容 的 Sql 语句 com.waylau.rest.dao.impl 中 


的 UserDaoImpl : 


getUserByld 修 改 成 如 下 : 


. 


QOverride 
public User getUserById(String id) { 
SessionFactory sessionFactory - HibernateUtil.getSessionFac 
Session s - null; 
Transaction t - null; 
User user - null; 
try{ 
S = sessionFactory.openSession(); 
t - s.beginTransaction(); 
String hql = "from User where userId='"+idt"'"; 
Query query - s.createQuery(hq1); 
user = (User) query.uniqueResult(); 
t.commit(); 
}catch(Exception err){ 
t.rollback(); 
err.printStackTrace(); 
}finally{ 
s.close(); 


} 


return user; 





getAllUsers 给 成 如 下 : 


QOverride 
public List«User» getAllUsers() ( 
SessionFactory sessionFactory - HibernateUtil.getSessionFac 
Session s - null; 
Transaction t - null; 
List«User» uesrs - null; 
tryt 
S = sessionFactory.openSession(); 
t - s.beginTransaction(); 
String hql - "select * from [RestDemo].dbo.t user"; 
Query query = s.createSQLQuery(hq1).addEntity(User.class); 
//query.setCacheable(true); // 设置 缓存 
uesrs - query.list(); 
t.commit(); 
}catch(Exception err){ 
t.rollback(); 
err.printStackTrace(); 
}finally{ 
s.close(); 


} 


return uesrs; 











或 者 如 下 : 


QOverride 
public List«User» getAllUsers() ( 
SessionFactory sessionFactory - HibernateUtil.getSessionFac 
Session s - null; 
Transaction t - null; 
List«User» uesrs - null; 
tryt 
S = sessionFactory.openSession(); 
t - s.beginTransaction(); 
String hql - " from User"; 
Query query - s.createQuery(hq1); 
//query.setCacheable(true); // 设置 缓存 
uesrs = query.list(); 
t.commit(); 
jcatch(Exception err){ 
t.rollback(); 
err.printStackTrace(); 
}finally{ 
s.close(); 


} 


return uesrs; 





9 ` Je] Æ 
可 能 会 出 现 如 下 错误 


ERROR: 指定 的 架构 名 称 "RestDemo" 不 存在 ， 或 者 您 没有 使 用 该 名 称 的 权限 。 

三 月 26，2014 3:38:43 TF org.hibernate.tool.hbm2ddl.SchemaUpdate e 
INFO: HHH000232: Schema update complete 

Hibernate: insert into RestDemo.T USER (userName, age, USERID) vali 
=A 26, 2014 3:38:43 TF org.hibernate.engine.jdbc.spi.SqlExceptic 
WARN: SQL Error: 208, SQLState: S0002 

=A 26, 2014 3:38:43 TF org.hibernate.engine. jdbc.spi.SqlExceptic 
ERROR: 对 象 名 'RestDemo.T USER' 无 效 。 





解决 方案 : 
将 配置 文件 中 的 hibernate.default schema 值 修改 为 如 下 即 可 : 


«property name="hibernate.default_schema">RestDemo.dbo</property> 


Ki 一 








用 Jersey 构 建 RESTful 服 务 


或 者 去 掉 上 面 的 配置 ， 在 “Userhbm.xml" 修 改 如 下 


«class name="User" table="T USER" schema="RestDemo.dbo"> 


本 章 源 码 : https://github.com/waylau/RestDemo/tree/master/jersey-demo6- 
sqlserver-hibernate 


https://github.com/waylau/RestDemo/tree/master/jersey-demo6.2-sqlserver- 
hibernate 
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Jersey+SQLServer+Hibernate4.3+Spring3.2 


一 、 总 体 说 明 


本 例 运 行 演示 了 用 Jersey 构建 RESTful 服务 中 ， 如 何 集成 Spring3 


二 、 环 境 


1. 上 文 的 项 目 RestDemo 
2. Spring 及 其 他 相关 的 jar ,导入 项 目 


i, aopalliance-1.0.jar 

车 commons-logging-1.1 jar 

lä] jersey-spring3-2.10.1 jar 

le, log4j-1.2.12 Jar 

| spring-aop-3.2.3.RELEASE jar 

le, spring-beans-3.2.3.RELEASE jar 
l| spring-bridge-2.3.0-b05Jar 

le) spring-context-3.2.3.RELEASE Jar 
læ, spring-core-3.2.3.RELEASE Jar 
i) spring-expression-3.2.3.RELEASE Jar 
车 | spring-web-3.2.3.RELEASE Jar 


EI oc 


1. 根 目 录 下 下 创建 Spring 的 配置 文件 applicationContext.xml ; 配置 如 
下 : <?xml version="1.0" encoding="UTF-8"?> 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-'http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:context-"http://www.springframework.org/schema/cor 
xsi:schemaLocation-'http://www.springframework.org/schen 

http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context 
http://www. springframework.org/schema/context/spring-context. 
> 
«1-- 激活 那些 已 经 在 g 容 器 里 注册 过 的 bean --» 
<context:annotation-config></context:annotation-config> 
<!-- 在 容器 中 注入 bean --> 
«bean id-"UserServiceImpl" class="com.waylau.rest.service.i 
«bean id-"UserDaoImpl" class="com.waylau.rest.dao.impl.User 


</beans> 


(V) a) 





2. 在 com.waylau.rest.service 和 com.waylau.rest.service.impl 下 分 别 
增加 UserService 和 UserServicelmpl ° 


UserService.java 


package com.waylau.rest.service; 
import java.util.List; 
import com.waylau.rest.bean.User; 
VE 
* User Service 接口 
£ Qauthor waylau.com 
* 2014-7-25 
Py 
public interface UserService ( 
public User getUserById(String id); 
public boolean deleteUserById(String id); 
public boolean createUser(User user); 


public boolean updateUser(User user); 


public List«User» getAllUsers(); 


UserServiceImpl.java 


package com.waylau.rest.service.impl; 


import java.util.List; 


import org.springframework.beans.factory.annotation.Autowired; 


import com.waylau.rest.bean.User; 
import com.waylau.rest.dao.impl.UserDaoImpl; 
import com.waylau.rest.service.UserService; 


7/58 12 


* User Service 接口 实现 
* (author waylau.com 
* 2014-7-25 


D 


public class UserServiceImpl implements UserService { 


@Autowired 
private UserDaoImpl userDaoImpl; 


public UserServiceImpl() í 
// TODO Auto-generated constructor stub 
} 


QOverride 

public User getUserById(String id) { 
return userDaoImpl.getUserById(id); 

} 


QOverride 

public boolean deleteUserById(String id) ( 
return userDaoImpl.deleteUserById(id); 

} 


QOverride 

public boolean createUser(User user) ( 
return userDaoImpl.createUser(user); 

} 


QOverride 

public boolean updateUser(User user) ( 
return userDaoImpl.updateUser(user); 

} 


QOverride 

public List«User» getAllUsers() { 
return userDaoImpl.getAllUsers(); 

} 








3. 修改 UserResource. java 


package com.waylau.rest.resources; 


import java.util.ArrayList; 
import java.util.List; 
import java.util.logging.Logger; 


import javax.ws.rs.Path; 

import javax.ws.rs.Produces; 
import javax.ws.rs.Consumes; 
import javax.ws.rs.PathParam; 
import javax.ws.rs.core.MediaType; 
import javax.ws.rs.DELETE; 

import javax.ws.rs.GET; 

import javax.ws.rs.POST; 


import javax.ws.rs.PUT; 
import org.springframework.beans.factory.annotation.Autowired; 


import com.waylau.rest.bean.User; 
import com.waylau.rest.service.impl.UserServiceImpl; 


[Pre 
* JH pon 
* (author waylau.com 
* 2014-7-26 
EN 
QPath("/users") 
public class UserResource { 
private static final Logger LOGGER - Logger.getLogger(UserF 


@Autowired 
private UserServiceImpl userServiceImpl; 


public UserResource() { 
LOGGER.fine("UserResource()"); 
j 


JESS 
* 增加 
* @param user 
7 
QPOST 
QConsumes((MediaType.APPLICATION XML, MediaType.APPLICATION 
public void createUser(User user) ( 
userServiceImpl.createUser(user); 
j 


yf Sis 
* 删除 
* @param id 


=Í 
QDELETE 
@Path("{id}") 
public void deleteUser(@PathParam("id")String id){ 
userServiceImpl.deleteUserById(id); 
} 


VASE 

* AER 

* @param user 

af 
@PUT 
QConsumes (MediaType.APPLICATION XML) 
public void updateUser(User user)( 

userServiceImpl.updateUser(user); 

} 


ARE 
* 根据 Id 查询 
* @param id 
* @return 
a 
QGET 
@Path("{id}") 
@Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION 
public User getUserById(@PathParam("id") String id){ 
User u - userServiceImpl.getUserById(id); 
return u; 


j 


EXER 
* 查询 所 有 
* @return 
d 
QGET 
QProduces((MediaType.APPLICATION XML, MediaType.APPLICATION 
public List«User» getAllUsers(){ 
List«User» users = new ArrayList<User>( ); 
users = userServiceImpl.getAllUsers(); 
return users; 





4. 修改 web.xml, 插 入 


<module-name>RestDemo</module-name> 


<listener> 


<listener-class>org.springframework.web.context.ContextLoader 
</listener> 


<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>classpath:applicationContext.xml</param-value> 
</context -param> 








** **39 30 A P addUser**** 

**** 4-44 9E A getAllUsers**** 

[{"userId": "002", "userName":"sdfs","age":"23", {"userId":"003", 
****4 HP updateUser * * ** 

ide A JA a 

006Susan33 

**** Big Pr À getAllUsers**** 


[{"userId": "002", "userName":"sdfs","age":"23", {"userId":"003", 
ck x DRE PE**** 


**** 4-44 PEZ getAllUsers**** 
[{"userId": "002", "userName":"sdfs","age":"23", {"userId":"003", 


< _ Ë 





本 章 源码 (Fjaré) : https://github.com/waylau/RestDemo/tree/master/jersey- 
demo7-sqlserver-hibernate-spring3 


HF Jersey74 Æ RESTfuUR 4 8-- 
Jersey+SQLServer+Hibernate4.3+Spring3.2+jq 


uery 
一 、 总 体 说 明 


本 例 运 行 演示 了 用 Jersey 构建 RESTful 服务 中 ， 如 何 集成 jQuery, 用 html 作 为 客户 
端 访问 RESTful 服务 。 


二 、 环 境 
1. Ex 497i À RestDemo 
2. jQuery 库 ,本 例 为 1.7.1 版 本 


=. ELE 


4 i Jersey-aemos-sqiserver-nipernate 
> Æ JAX-WS Web Services 
> ‘ga Deployment Descriptor: jersey: 
> 5 Java Resources 
> Œ JavaScript Resources 
(5 build 
4 (> WebContent 


m 


4 (= css 
Ig styles.css| 
4 (= js 


b [B] jquery-1.7.1.min.js 
b main.js 

> (= META-INF 

b (5 WEB-INF 
E] index.html 





1. 创建 jQuery 客户 端的 项 目 结 构 ， 在 WebContent 创建 js , css 两 个 目录 ， 
并 把 jQuery Æ HA js 目录 下 ， 并 在 该 目录 下 创建 main,js 空 文件 


2. 在 Webcontent 创建 index.html : 


<!DOCTYPE HTML» 
«html» 
«head» 
<title>jquery Demo (A ##A%)</title> 
«meta charset="utf-8"/> 
<link rel="stylesheet" href="css/styles.css" /> 


<script src="js/jquery-1.7.1.min.js"></script> 
<script src="js/main.js"></script> 
</head> 


<body> 
<div class="header"> 


<button id="btnClear">Clear</button> 

<button id="btnRefreash">Refreash</button> 

更 多 实例 访问 : <a href="http://ww.waylau.com" >www.wa 
</div> 


<div class="leftArea"> 

<ul id="userList"></ul> 
</div> 
<form id="wineForm"> 

<div class="mainArea"> 


<label>Id:</label> <input id="userId" name="use 


<label>Name:</label> <input type="text" id="use 
<label>Age:</label> <input type="text" id="age 


<button id="btnAdd">Add</button> 

«button id="btnSave">Save</button> 

<button id="btnDelete">Delete</button> 
</div> 


</form> 


</body> 
</html> 


-| EM 





. 修改 main.js 


// The root URL for the RESTful services 
var rootURL = 'http://localhost:8089/RestDemo/rest/users'; 


var currentUser; 


// Retrieve wine list when application starts 


findAll(); 


// Nothing to delete in initial application state 
$('#btnDelete').hide(); 


$('#btnAdd').click(function() í 
addUser( ); 
return false; 


3): 


$('#btnSave').click(function() { 


updateUser(); 
return false; 


7); 


$('#btnClear').click(function() { 
newUser(); 
return false; 


3): 


$('#btnDelete').click(function() { 
deleteUser(); 
return false; 


3): 


$('#userList a').live('click', function() { 
findById(S$(this).data('identity')); 
3); 


$('#btnRefreash').click(function() { 
findAll(); 
return false; 


7); 


function newUser() { 
$('#btnDelete').hide(); 
currentUser = {}; 
renderDetails(currentUser); // Display empty form 


} 


function findAll() { 
console.log('findAll'); 
$.ajax({ 
type: 'GET', 
url: rootURL, 
dataType: "json", // data type of response 
success: renderList 
3); 
} 


function findById(id) { 
console.log('findById: ' + id); 


$.ajax({ 


3): 
} 


type: 'GET', 

url: rootURL + "/* + id, 

dataType: "json", 

success: function(data){ 
$('#btnDelete').show(); 


console.log('findById success: ' + data.userNan 
currentUser = data; 
renderDetails(currentUser ) ; 


function addUser() { 
console.log('addUser'); 
$.ajax({ 


I); 
} 


type: 'POST', 

contentType: 'application/json', 

url: rootURL, 

dataType: "json", 

data: formToJSON(), 

success: function(data, textStatus, jqXHR){ 
alert('User created successfully'); 
$('#btnDelete').show(); 
$('#userId').val(data.userId); 


3 

error: function(jqXHR, textStatus, errorThrown){ 
alert('addUser error: ' + textStatus); 

j 


function updateUser() ( 
console.log('updateUser'); 
$.ajax({ 


+); 


type: 'PUT', 


contentType: 'application/json', 
url: rootURL, 

dataType: "json", 

data: formToJSON(), 


success: function(data, textStatus, jqXHR){ 
alert('User updated successfully'); 


ty 

error: function(jqXHR, textStatus, errorThrown) { 
alert('updateUser error: ' + textStatus); 

j 


function deleteUser() { 
console.log('deleteUser'); 
$.ajax({ 
type: 'DELETE', 
url: rootURL + '/' + $('#userId').val(), 
success: function(data, textStatus, jqXHR){ 
alert('user deleted successfully'); 
tr 
error: function(jqXHR, textStatus, errorThrown){ 
alert('delete user error'); 


3); 
} 


function renderList(data) { 
// JAX-RS serializes an empty list as null, and a 'coll 
var list - data -- null ? [] : (data instanceof Array * 


$('#userList li').remove(); 
$.each(list, function(index, data) { 
$('#userList').append('<li><a href="#" data-identit 
3); 
J 


function renderDetails(data) ( 
$('#userId').val(data.userId); 
$('#userName').val(data.userName) ; 
$('#age').val(data.age); 


} 


// Helper function to serialize all the form fields into a 
function formToJSON() í 
var userId = $('#userId').val(); 
return JSON.stringify({ 
"userId": userId == "" ? null : userId, 
"userName": $('#userName').val(), 
"age": $('#age').val() 
Ð; 





4. 在 css 目录 下 创建 styles.css 文件 


EET 
font-family: "Helvetica Neue", Helvetica, Arial, sans-ser 
font-size: 18px; 


j 


.header ( 
padding-top: 5px; 


} 


.leftArea { 
position: absolute; 
left: 10px; 
top: 70px; 
bottom: 20px; 
width: 260px; 
border:solid 1px #CCCCCC; 
overflow-y: scroll; 


} 


.mainArea { 
position: absolute; 
top: 70px; 
bottom: 20px; 
left:300px; 
overflow-y: scroll; 
width:300px; 

} 


.rightArea { 
position: absolute; 
top: 70px; 
bottom: 20px; 
left:650px; 
overflow-y: scroll; 
width:270px; 


} 

ul { 
list-style-type: none; 
padding-left: Opx; 
margin-top: Opx; 

} 

ibat 
text-decoration:none; 
display: block; 
color: #000000; 
border-bottom:solid 1px #CCCCCC; 
padding: 8px; 

J 


li a:hover ( 
background-color: #4BOA1E; 
color: #BA8A92; 


} 


input, textarea { 
border:1px solid #ccc; 
min-height :30px; 


outline: none; 


j 


.mainArea input { 
margin-bottom:15px; 
margin-top:5px; 
width: 280px; 

j 


textarea ( 
margin-bottom:15px; 
margin-top:5px; 
height: 200px; 
width:250px; 

} 


label { 
display:block; 


button { 
padding:6px; 
} 


ZsearchKey { 
width:160px; 





2. 可 以 进行 CURD 操 作 


用 Jersey 构 建 RESTful 服 务 





€ > C fi CO localhost:8089/RestDemo/# 








Clear.  Refreash 更 多 实例 访问 : www.waylau.com 





sdfs ~ id 3 
10 
sdfs 
sa Name: 
| 
sdfs ey 
way Age: 
98 
waylau 
w Add Save 
waylau 


PS: 本 案例 力求 简单 把 jquery 访问 RESTful 服务 展示 出 来 ， 代 码 只 在 Chrome 上 做 过 
测试 。 


本 章 源 码 : https://github.com/waylau/RestDemo/tree/master/jersey-demo8- 
sqlserver-hibernate-spring3-jquery 
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HF Jersey? Æ RESTfuUR 5 9-- 
Jersey+SQLServer+Hibernate4.3+Spring3.2+An 
gularJS 


一 、 总 体 说 明 


本 例 运行 演示 了 用 Jersey 构建 RESTful 服务 中 ， 如 何 集成 angular, 用 MVC 分 层 的 
方式 访问 RESTful 服务 。 


二 、 环 境 


. 上 上 文 的 项 目 Demo?) 
. angular 库 ,本 例 为 1.2.3 版 本 
. 样式 bootstrap-3.1.1.min.js 


WON 一 


三 、 配 置 


1. 完成 项 目 结构 


4 Ey jersey-demo9-sqlserver-hibernate-angularjs 
> Æ JAX-WS Web Services 
> ‘ga Deployment Descriptor: jersey-demo9-sql 
> 78 Java Resources 
> Bá JavaScript Resources 
> build 
4 (> WebContent 
> css 
b 2 META-INF 
> (= partials 
> (= WEB-INF 


创建 相应 的 目录 结构 

angularjs ` bootstrap 的 js,css 文 件 放 别 放 入 相应 的 目录 ， 

在 js 目录 下 再 创建 app.js ^ controller.js 

在 partials 目 录 下 再 创建 create.html ^ list.html ^ detail.html 
完整 目录 结构 如 下 


4 E jersey-demo9-sqlserver-hibernate-angularjs 
b Æ JAX-WS Web Services 
> ‘Gg Deployment Descriptor: jersey-demo9-sqlserver-hibe 
b 29 Java Resources 
> wa JavaScript Resources 
> & build 
4 (> WebContent 
4 (> css 
E] bootstrap.min.css 
4 (js 
[g] angular-1.2.3,js 
> angular-cookies-1.2.3.js 
angular-resource-1.2.3.s 
angular-route-1.2.3,js 
图 apps 
b bootstrap-3.1.1.min.s 
controller.js 
b (= META-INF 
4 (= partials 
E] create.html 
EH detail.html 
E] listhtml 
> (= WEB-INF 
=] index.html 








2. 在 list.html 填 入 如 下 内 容 ,主要 是 显示 用 户 列 表 ng-repeat 7 angularjs 
迭代 器 作用 是 数据 绑 定 : 


«div class="pull-right"> 
«a href="#/create" class="btn btn-default" title="Creat 


</div> 

«div class="page-header"> 
<h3>Users</h3> 

</div> 

<hr /> 


<li ng-repeat="user in users | filter:query | orderBy:order 


«div class="pull-right"> 
«a href="#/users/" class="btn btn-xs btn-default" t 
<span class="glyphicon glyphicon-pencil"></span></a> 
</div> 
«h4»userId: </h4> 
<p>userName:<a href="#/users/"></a>  Age:</p> 
<hr /> 
</li> 


«hr /» 








3. 修改 create.html 用 来 添加 用 户 信 息 ， ng-model 是 模型 


«div class="page-header"> 
<h3>Create</h3> 
</div> 


<form role="form" name="userForm"> 


<div class="row">&nbsp; </div> 
«div class="row" ng-class="{'has-error': userForm.userId.¢ 
<div class="col-md-1"> 
<i ng-show="userForm.url.$error. required" 
class="glyphicon glyphicon-pencil"></i> 
«label for="urlInput">userId</label> 


</div> 
<div class="col-md-4"> 
<input 
type="test" 


class="form-control" id="urlInput" 
name="userId" ng-model="user.userId" required» 
</div> 
</div> 
«div class="row">&nbsp; </div> 


<div class="row" ng-class="{'has-error': userForm.userName. 
<div class="col-md-1"> 
<i ng-show="userForm.userName.$error. required" 
class="glyphicon glyphicon-pencil"></i> 
«label for="nameInput">userName</label> 


</div> 
<div class="col-md-4"> 
<input 
type="text" 


class="form-control error" id="nameInput" 
name="userName" 
ng-model-"user.userName" 
required» 
«/div» 
«/div» 


«div class-"row"»&nbsp;«/div» 
«div class="row" ng-class="{'has-error': userForm.url.$inve 
«div class="col-md-1"> 
«i ng-show="userForm.url.$error.required" 
class="glyphicon glyphicon-pencil"></i> 
«label for="urlInput">age</label> 


</div> 
<div class="col-md-4"> 
<input 
type="text" 


class="form-control" id="urlInput" 
name="age" ng-model="user.age" required> 
</div> 
</div> 


«div class="row" ng-hide-"showConfirm"- 
«div class="col-md-5"> 
«a href="#users" class="btn">Cancel</a> 


<button 
ng-click="add()" 
ng-disabled="isClean() || userForm.$invalid" 


class="btn btn-primary">Save</button> 


</div> 
</div> 


‘| 








4. 修改 detail.html 用 来 显示 用 户 信息 并 提供 修改 、 删 除 等 功能 


«form role="form" name="userForm"> 


«div class="row">&nbsp; </div> 
«div class="row" ng-class="{'has-error': userForm.userId.¢ 
<div class="col-md-1"> 
<i ng-show="userForm.url.$error. required" 
class="glyphicon glyphicon-pencil"></i> 
«label for="urlInput">userId</label> 


</div> 
<div class="col-md-4"> 
<input 
type="test" 


class="form-control" id="urlInput" 
name="userId" ng-model="user.userId" required> 
</div> 
</div> 
<div class="row">&nbsp;</div> 


<div class="row" ng-class="{'has-error': userForm.userName. 
<div class="col-md-1"> 
<i ng-show="userForm.userName.$error. required" 
class="glyphicon glyphicon-pencil"></i> 
<label for="nameInput">userName</label> 


</div> 
<div class="col-md-4"> 
<input 
type="text" 


class="form-control error" id="nameInput" 
name="userName" 
ng-model-"user.userName" 
fend-focus="focusUserNameeInput" 
required> 
</div> 

</div> 

«div class="row">&nbsp; </div> 

«div class="row" ng-class="{'has-error': userForm.url.$inve 


«div class="col-md-1"> 
«i ng-show="userForm.url.$error.required" 
class-"glyphicon glyphicon-pencil"></i> 
«label for="urlInput">age</label> 


«/div» 
«div class="col-md-4"> 
«input 
type="text" 


class="form-control" id="urlInput" 


name="age" ng-model="user.age" required> 
</div> 
</div> 


«div class="row" ng-hide="showConfirm">&nbsp; </div> 


«div class="row" ng-hide-"showConfirm"- 
«div class="col-md-5"> 
«a href="#users" class="btn">Cancel</a> 


<button 
ng-click="save()" 
ng-disabled="isClean() || userForm.$invalid" 
class="btn btn-primary">Save</button> 
<button 


ng-click="remove()" 
ng-show="user .userId" 
class="btn btn-danger">Delete</button> 


</div> 
</div> 
«/form» 


SSS | 





. 修改 index.html AER do RALUWFR D> ng-app 声明 这 个 是 模 


> ng-controller 说 明 他 的 控制 器 叫 Listctrl , ng-view 用 来 存放 子 
视图 (Rm) o 


<!doctype html> 
«html ng-app="appMain" ng-controller="ListCtrl"> 
<head> 
<meta charset="utf-8"/> 
<meta name="viewport" content="width=device-width, init 
<link rel="stylesheet" href="css/bootstrap.min.css" tyr 


</head> 

<body > 
<!-- navbar --> 
«div class="container ng-view"></div> 
<!-- footer --> 


<div id="footer" class="hidden-xs"> 
«div class="container"> 
<p class="text-muted"> 
Project Example - by «a href="http://www.waylau.c 
«a href="https://github.com/waylau" target-" blar 
</p> 
</div> 
</div> 


«script src="js/bootstrap-3.1.1.min.js"></script> 
<script src="js/angular-1.2.3.js"></script> 

<script src="js/angular-resource-1.2.3.js"></script> 
<script src="js/angular-route-1.2.3.js"></script> 
<script src="js/angular-cookies-1.2.3.js"></script> 


<script src="js/app.js"></script> 
<script src="js/controller.js"></script> 
</body> 
</html> 


sl 


. 修改 app.js ， 声 明 模 块 appMain ,提供 路 由 功能 ， 说 明了 调转 到 哪个 页 
面 ， 用 哪个 控制 器 





angular.module('appMain', ['ngRoute']).config(['$routeProvider 
$routeProvider. 
when('/users', (templateUrl: 'partials/list.html', 
when('/users/:userId', {templateUrl: 'partials/dete 
when('/create', ( 
templateUrl: 'partials/create.html', 
controller: CreateController 
3). 
otherwise({redirectTo: '/users'}); 


31); 


aj 








. 修改 controller.js ， 控 制 器 。 主 要 是 对 业务 逻辑 的 操作 ， 常 见 的 CURD 功 
能 ，http 访 问 RESTful 接 口 ， 并 且 返 回 数据 


var url = 'http://1localhost:8089/RestDemo/rest'; 


function ListCtrl($scope, $http) { 
$http.get( url + '/users' ).success(function(data) ( 
$scope.users - data; 


3): 


$scope.orderProp - 'age'; 


j 
function DetailCtrl($scope, $routeParams, $http) { 


$http.get( url + '/users/'-*$routeParams.userId).success 
$scope.user - data; 


3); 


$scope.save = function() { 
$http.put( url + '/users', $scope.user). 
success(function(data, status, headers, config) { 
$location.path('/'); 
}).error(function(data, status, headers, config){ 
alert("error"+status); 
3); 
H 


$scope.remove = function(){ 
$http({ 
method: 'DELETE', 
url: url + '/users/'+ $scope.user.userId , 
3) 
.Success(function(data, status, headers, config){ 
$1ocation.path('/'); 
}).error(function(data, status, headers, config){ 
alert("error"+status); 
3) ; 
u 
} 


function CreateController($scope, $http) { 


$scope.add = function() { 
$http.post( url + '/users',  $scope.user). 
success(function(data, status, headers, config){ 
$location.path('/'); 
}).error(function(data, status, headers, config){ 
alert("error"+status); 
Ð ; 
N 








用 Jersey 构 建 RESTful 服 务 
四 、 运 行 


1. 先 运行 项 目 


2. 可 以 进行 CURD 操 作 
€) > [Blocshostded/ResDemo/s/user: "W BR" C| E D) à B f Sr N- > 三 
B 访问 最 多 L Jaume (2 新 手 上 路 O MARIN À] sees (MIER) 








十 


Users 


» userld: 16 
userName:way Age:2141 


+ userid: 15 


userName:way Age:22 


+ userid: 003 


userName:sdfs Age: 23 


+ userid: 004 


userName: sdfs Age: 23 


«€ )BPlocathosts089/RestDemo/#fusersi9 VER C i Ad -oXP YT & f Hr Ur » = 
Bw J) AMOS ( ) 新手 上 路 Ru E) 2095 (FARE) 





userid 


9 


userName 


waylau 
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Cancel 


Project Example - by www.waylau.com | GitHub Project 


PS: 本 案例 力求 简单 把 angularjs 访问 RESTful 服务 展示 出 来 ， 在 Chrome,firefox,IE 
上 做 过 测试 。 


本 章 源码 : jersey-demo9-sqlserver-hibernate-spring3-angularjs 
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用 Jersey 2 和 Spring 4 构建 RESTful web 
service 


本 文 介绍 了 如 何 通 过 Jersey 框架 优美 的 在 Java 实现 了 REST 的 API ° CRUD 的 
操作 存储 在 MySQL 中 


1. 示例 


1.1 为 什么 


Spring 可 以 对 于 REST 有 自己 的 实现 ( 见 https://spring.io/guides/tutorials/rest/) ° 
但 本 文 展示 的 是 用 “官方 ” 的 方法 来 实现 REST ， 即 使 用 Jersey。 


1.2 它 是 做 什么 的 ? 


管理 资源 。REST API 将 允许 创建 、 检 索 、 更 新 和 删除 这 样 的 资源 。 


3 架构 及 技术 


本 示例 项 目 使 用 多 层 结构 ， 基 于 “Law of Demeter (LoD) or principle of least 
knowledge” CE RAM) ， 是 说 一 个 软件 实体 要 尽 可 能 的 只 与 和 它 最 近 的 实体 进 
行 通讯 。 通 常 被 表述 为 : talk only to your immediate friends ( 只 和 离 你 最 近 的 朋友 
进行 交互 )。 "talk”， 其 实 就 是 对 象 间 方 法 的 调用 。 这 条 规则 表明 了 对 象 间 方法 调用 
的 原则 : (1) 调用 对 象 本 身 的 方法 (2) 调用 通过 参数 传 入 的 对 象 的 方法 ; 

(3) 在 方法 中 创建 的 对 象 的 方法 ; (4) 所 包含 对 象 的 方法 。 


e 第 一 层 : Jersey 实现 对 REST 的 支持 ， 拥 有 外 观 模式 的 角色 并 代理 到 逻辑 业 


B: RAB BM 
e 数据 访问 层 : 是 与 持久 数据 存储 (在 我 们 的 例子 中 是 MySql 数 据 库 ) 交 互 的 地 


简 述 下 技术 框架 : 


1.3.1. Jersey (外 观 ) 


Jersey 是 开源 、 拥 有 产品 级 别 的 质量 ， 提 供 构 建 RESTful Web Services, 支 持 JAX- 
RS APIs ， 提 供 JAX-RS (JSR 311 & JSR 339) 参考 实现 。 


1.3.2. Spring (LJ Æ) 


在 我 看 来 没有 什么 比 Spring 更 好 的 办 法 让 pojo 具有 不 同 的 功能 。 你 会 发 现在 本 
教程 用 Jersey 2 和 Spring 4 构建 RESTful web service 


1.3.3. JPA 2 / Hibernate (持久 层 ) 


使 用 Hibernate 实现 DAO 模式 。 


1.3.4. Web &4 


用 Maven 打包 成 war 文件 开源 部 署 在 任意 容器 。 一 般 用 Tomcat 和 Jetty ， 也 可 
以 是 Glassfih, Weblogic, JBoss 或 WebSphere. 


1.3.5. MySQL 数据 库 
示例 数据 存储 在 一 个 MySQL X: 


1.3.6. 技术 版 本 


Jersey 2.9 
Spring 4.0.3 
Hibernate 4 
Maven 3 
Tomcat 7 
Jetty 9 
MySql 5.6 


1.4. 源码 
JLhttps://github.com/waylau/RestDemo/tree/master/jersey-2-spring-4-rest 
2. 配置 

开始 呈现 REST API 的 设计 和 实现 之 前 ,我 们 需要 做 一 些 配置 。 


2.1. 项 目 依赖 


Jersey Spring 扩展 包 是 必须 要 放 在 项 目 classpath 中 。 在 pom.xml 中 添加 下 面 依 
5 : 


«dependency» 
«groupId»org.glassfish.jersey.ext«/groupId- 
<artifactId>jersey-spring3</artifactId> 
<version>${jersey.version}</version> 
<exclusions> 

<exclusion> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-core</artifactId> 
</exclusion> 
<exclusion> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-web</artifactId> 
</exclusion> 
<exclusion> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-beans</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 
<dependency> 
<groupId>org.glassfish. jersey .media</groupid> 
<artifactId>jersey-media-json-jackson</artifactId> 
<version>2.4.1</version> 
</dependency> 


注意 : jersey-spring3.jar 使 用 的 是 他 自己 的 Spring 库 版 本 ， 所 以 如 果 你 想 使 用 自己 
的 (本 例 是 使 用 Spring 4.0.3.Release), 你 需要 将 这 些 库 手 动 的 移 除 。 如 果 想 看 到 其 
他 的 库 的 依赖 ， 请 查看 项 目 源码 中 的 pom.xml 


2.2. web.xml 


应 用 部 署 描述 


<?xml version="1.0" encoding="UTF-8"?> 

«web-app version="3.0" xmins="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://java.sun.com/xml/ns/javaee http://jé 
<display-name>Demo - Restful Web Application</display-name> 


<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 


<context -param> 
<param-name>contextConfigLocation</param-name> 
<param-value>classpath:spring/applicationContext.xml</parar 
</context -param> 


<servlet> 
<servlet -name>jersey-serlvet</servlet -name> 
<servlet-class> 
org.glassfish.jersey.servlet.ServletContainer 
</servlet-class> 
<init -param> 
<param-name>javax.ws.rs.Application</param-name> 
<param-value>org.codingpedia.demo.rest.RestDemoJaxRSAp} 
</init-param> 
<load-on-startup>1</load-on-startup> 
</servlet> 


<servlet-mapping> 
<servlet-name>jersey-serlvet</servlet-name> 
<url-pattern>/*</url-pattern> 
</servlet-mapping> 


<resource-ref> 
<description>Database resource rest demo web application <, 
<res-ref-name>jdbc/restDemoDB</res-ref-name> 
<res-type>javax.sql.DataSource</res-type> 
<res-auth>Container</res-auth> 
</resource-ref> 
</web-app> 





2.2.1. Jersey-servlet 


注意 Jersey servlet 的 配置 ， javax.ws.rs.core.Application 类 定义 了 JAX- 
RS 应 用 组 件 (root 资源 和 提供 者 类 ) .本 例 使 用 ResourceConfig , Æ Jersey À 
己 实现 的 Application 类 ， 提 供 了 简化 JAX-RS 组 件 的 能 力 。 详 见 JAX-RS 应 
用 模型 


org.codingpedia.demo.rest.RestDemoJaxRsApplication 是 自己 实现 的 
ResourceConfig 类 ， 注 册 应 用 的 resources, filters, exception mappers 和 
feature : 


package org.codingpedia.demo.rest.service; 
//imports omitted for brevity 


Fe 
* Registers the components to be used by the JAX-RS application 


* 


* @author ama 
* 
a 
public class RestDemoJaxRsApplication extends ResourceConfig { 


JESS 
* Register JAX-RS application components. 
ie 
public RestDemoJaxRsApplication() { 
// register application resources 
register(PodcastResource.class); 
register(PodcastLegacyResource.class); 


// register filters 
register(RequestContextFilter.class); 
register(LoggingResponseFilter.class); 
register(CORSResponseFilter.class); 


// register exception mappers 
register(GenericExceptionMapper.class); 
register(AppExceptionMapper.class); 
register(NotFoundExceptionMapper.class); 


// register features 
register(JacksonFeature.class); 
register(MultiPartFeature.class); 


e org.glassfish.jersey.server.spring.scope.RequestContextFilter 
是 Spring filter 提供 了 JAX-RS 和 Spring 请 求 属 性 之 间 的 桥梁 。 

e org.codingpedia.demo.rest.resource.PodcastsResource 这 是 “外 观 " 组 
件 ， 通 过 注解 暴露 了 REST 的 API。 稍 后 会 描述 

e org.glassfish.jersey.jackson.JacksonFeature ,是 一 个 feature > M 
Jackson JSON 的 提供 者 来 解释 JSON 。 


2.1.2. Spring 配置 


配置 文件 在 classpath 目录 下 的 spring/applicationContext.xml: 


«beans xmlnsz"http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:context-"http://www.springframework.org/schema/context" 
xmlns:tx-"http://www.springframework.org/schema/tx" 
xsi:schemaLocation-" 


http://www.springframework.org/schema/beans 

http://www.springframework.org/schema/beans/spring-beans.x: 

http://www.springframework.org/schema/tx 

http://www.springframework.org/schema/tx/spring-tx.xsd 

http://www.springframework.org/schema/context 

http://www.springframework.org/schema/context/spring-conte» 
«context:component-scan base-package="org.codingpedia.demo.resti 
Ie KKKKKKKKKKKK JPA configuration KKKKKKKKKKK S 


«tx:annotation-driven transaction-manager-"transactionManager" 
«bean id="transactionManager" class="org.springframework.orm. jf 
<property name="entityManagerFactory" ref="entityManagerFac 


</bean> 


<bean id="transactionManagerLegacy" class="org.springframework 
<property name="entityManagerFactory" ref="entityManagerFac 


</bean> 


<bean id="entityManagerFactory" class="org.springframework.orm 


«property name-"persistenceXmlLocation" value="classpath: cc 
«property name="persistenceUnitName" value-z"demoRestPersis! 
«property name="dataSource" ref="restDemoDS" /> 
«property name-"packagesToScan" value-"org.codingpedia.dem: 
«property name="jpaVendorAdapter'"> 
«bean class-"org.springframework.orm.jpa.vendor.Hibern: 
«property name="ShowSql" value="true" /> 
«property name="databasePlatform" value-"org.hiberr 
</bean> 
</property> 
</bean> 


«bean id="entityManagerFactoryLegacy" class="org.springframewoi 


«property name-"persistenceXmlLocation" value="classpath: cc 
«property name="persistenceUnitName" value-z"demoRestPersis! 
«property name="dataSource" ref="restDemoLegacyDS" /> 
«property name="packagesToScan" value="org.codingpedia.demc 
«property name="jpaVendorAdapter'"> 
<bean class-"org.springframework.orm.jpa.vendor.Hibern: 
«property name="ShowSql" value="true" /> 
«property name="databasePlatform" value="org.hiberr 
</bean> 
</property> 


</bean> 


«bean id="podcastDao" class-"org.codingpedia.demo.rest.dao.Pod 
«bean id="podcastService" class="org.codingpedia.demo.rest.ser\ 
<bean id="podcastsResource" class="org.codingpedia.demo.rest.re 
<bean id="podcastLegacyResource" class="org.codingpedia.demo.re 


«bean id="restDemoDS" class="org.springframework. jndi.JndiObjec 
<property name="jndiName" value="java:comp/env/jdbc/restDer 
<property name="resourceRef" value="true" /> 

</bean> 

<bean id="restDemoLegacyDS" class="org.springframework. jndi. Jnc¢ 
<property name="jndiName" value="java:comp/env/jdbc/restDer 
<property name="resourceRef" value="true" /> 

</bean> 

</beans> 


UE] 


其 中 podcastsResource 是 指向 REST API 实体 





3. REST API (设计 与 实现 ) 


3.1.1. 设计 
REST 中 的 资源 主要 包括 下 面 两 大 思想 : 


e 每 个 都 指向 了 全 球 标 示 符 (de > HTTP 中 的 URI) 
e 有 一 个 或 多 个 表示 (我 们 将 在 本 示例 使 用 JSON 格式 ) 


REST 中 的 资源 一 般 是 名 词 (podcasts, customers, user, accounts F) 而 不 是 名 词 
(getPodcast, deleteUser F) 


本 教程 使 用 的 端点 有 : 


e /podcasts 一 (注意 复数 ) URI 标 识 的 资源 podcasts 集合 的 播客 
e /podcasts/{id} 一 通过 podcasts 的 |D, URI 标识 一 个 podcasts 资源 ， 


3.1.2. 实现 
为 求 精简 > podcast 只 包含 下 列 属性 : 


id — podcast 的 唯一 标识 
feed — podcast 的 feed url 
title — 标题 
linkOnPodcastpedia — 链接 
description — 描述 


我 用 了 两 种 Java 类 来 表示 podcast 代码 ， 是 为 了 避免 类 及 其 属性 /方法 被 IPA 和 
XML/JAXB/JSON 的 注释 堆 满 了 : 


e PodcastEntity.java 一 JPA 注解 类 用 在 DB 和 业务 层 
e Podcast.java 一 JAXB/JSON 注解 类 用 在 外 观 和 业务 层 


Podcast.java 


package org.codingpedia.demo.rest.resource; 
//imports omitted for brevity 


JESSE 
* Podcast resource placeholder for json/xml representation 
* 


* @author ama 

* 

SÅ 
QSuppresswarnings("restriction") 
QXmlRootElement 
QXmlAccessorType(XmlAccessType.FIELD) 
public class Podcast implements Serializable { 


private static final long serialVersionUID - -8039686696076337( 


/** id of the podcast */ 
QXmlElement(name = "id") 
private Long id; 


/** title of the podcast */ 
QXmlElement(name - "title") 
private String title; 


/** link of the podcast on Podcastpedia.org */ 
QXmlElement(name = "linkOnPodcastpedia") 
private String linkOnPodcastpedia; 


/** url of the feed */ 
QXmlElement(name = "feed") 
private String feed; 


/** description of the podcast */ 
QXmlElement(name = "description") 
private String description; 


/** insertion date in the database */ 
QXmlElement(name = "insertionDate") 
QXmlJavaTypeAdapter(DatelSO8601Adapter.class) 
@PodcastDetailedView 

private Date insertionDate; 


public Podcast(PodcastEntity podcastEntity) { 


try { 
BeanUtils.copyProperties(this, podcastEntity); 


) catch (IllegalAccessException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 

} catch (InvocationTargetException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


j 


public Podcast(String title, String linkOnPodcastpedia, String 
String description) ( 


this.title - title; 
this.linkOnPodcastpedia - linkOnPodcastpedia; 


this.feed - feed; 
this.description - description; 


j 
public Podcast(){} 


//getters and setters now shown for brevity 


) 
ab TH 
转化 成 JSON 输出 如 下 





"1d: 

"title":"Quarks & Co - zum Mitnehmen-modified", 
"linkOnPodcastpedia":"http://www.podcastpedia.org/podcasts/1/Qi 
"feed":"http://podcast.wdr.de/quarks.xml", 
"description":"Quarks & Co: Das Wissenschaftsmagazin", 
"insertionDate":"2014-05-30T10:26:12.00+0200" 


} 
al — : 





3.2. Zr ik 
简单 的 说 明 


创建 = POST 
读 = GET 
更 新 = PUT 
删除 = DELETE 


但 不 是 一 一 映射 ， 因 为 PUT 也 可 以 创建 ，POST 也 可 以 用 在 更 新 。 


Æ : 读 取 和 删除 它 是 很 清楚 的 ， 他 们 确实 是 和 GET 、DELETE 一 对 一 的 映射 。 无 
论 如 何 ，REST 是 一 种 架构 风格 ， 不 是 一 个 规范 ， 你 应 该 适应 你 的 架构 需要 ， 但 如 
果 你 想 让 你 的 API 让 更 多 的 公众 愿意 使 用 它 ， 你 应 该 遵循 一 定 的 “最 佳 实践 ”。 


PodcastRestResource 类 是 处 理 所 有 的 请 求 


package org.codingpedia.demo.rest.resource; 
//imports 
Component 
QPath("/podcasts") 
public class PodcastResource { 
@Autowired 
private PodcastService podcastService; 


注意 类 定义 前 面 的 @Path("/podcasts") > FA 5 podcast 关联 的 资源 都 会 出 现 
在 这 个 路 径 下 。 @Path 注解 值 是 关联 URI 的 路 径 。 


在 上 面 的 例子 中 ， 该 Java 类 将 托管 在 /podcasts URI %4% o+ PodcastService 
接口 公开 的 业务 逻辑 到 REST 外 观 层 。 
3.2.1. 创建 podcast 


3.2.1.1. Xt 


常见 的 的 方式 利用 POST 创建 资源 ， 如 前 所 述 ， 创 建 一 个 新 的 资源 ， 可 以 用 POST 
和 PUT 的 方法 ， 我 是 这 样 做 的 : 


| Description | URI | HTTP method | HTTP Status response | | --- | --- | --- | --- | | 
增加 新 的 podcast | /podcasts/ | POST | 201 Created | | 增加 新 的 podcast (必须 传 
所 有 的 值 ) | /podcasts/(id) | PUT | 201 Created | 


PUT POST 最 大 的 区 别 是 ，PUT 就 是 把 你 应 该 事先 知道 资源 将 被 创建 的 位 置 和 发 
送 所 有 可 能 值 的 实体 。 


3.2.1.2. 实现 


3.2.1.2.1. POST 创建 一 个 单 资 源 


Adds a new resource (podcast) from the given json format (at le: 
and feed elements are required at the DB level) 


Qparam podcast 
Qreturn 
Qthrows AppException 


+I F FF FF 


27 
QPOST 
@Consumes({ MediaType.APPLICATION JSON }) 
@Produces({ MediaType.TEXT HTML }) 
public Response createPodcast(Podcast podcast) throws AppException 
Long createPodcastId = podcastService.createPodcast(podcast); 
return Response.status(Response.Status.CREATED)// 201 
.entity("A new podcast has been created") 
.header( "Location", 
"http://localhost :8888/demo-rest-jersey-spring, 
+ String. valueOf(createPodcastId) ) .bui- 





e QPOST 一 指示 方法 响应 到 HTTP POST 35 À 
o (QConsumes((MediaType.APPLICATION JSON]) 一 定义 方法 可 以 接受 的 
媒体 类 型 ， 本 例 为 "application/json" 
o @Produces({MediaType.TEXT_HTML}) 一 定义 方法 产生 的 媒体 类 型 本 例 
为 "text/html" 


响应 
° RA: HTTP 状态 为 201 的 text/html 文件 和 头 的 位 置 指定 的 资源 已 被 创建 
dcs 没有 足够 的 数据 提供 
o 409 : 冲突 了 。 如 果 在 服务 器 端 被 确定 具有 相同 的 podcast 的 存在 
3.2.1.2.2. 通过 PUT 创建 单 资源 (“podcast”) 
这 将 执行 更 新 Podcast 处 理 。 


3.2.1.2.3. 附加 一 通过 表单 创 建 (*podcast") 资 源 


* 


Adds a new podcast (resource) from "form" (at least title and fe 
elements are required at the DB level) 


Qparam linkOnPodcastpedia 
Qparam feed 
Qparam description 
@return 
@throws AppException 
D 
@POST 
@Consumes({ MediaType.APPLICATION_FORM_URLENCODED }) 
@Produces({ MediaType.TEXT_HTML }) 
@Transactional 
public Response createPodcastFromApplicationFormURLencoded( 
QFormParam("title") String title, 
QFormParam("linkOnPodcastpedia") String linkOnPodcastpedia, 
QFormParam("feed") String feed, 
QFormParam("description") String description) throws AppExt 


* 
* 
* 
* 
* @param title 
* 
* 
* 
* 
* 


Podcast podcast - new Podcast(title, linkOnPodcastpedia, feed, 
description); 
Long createPodcastid - podcastService.createPodcast(podcast); 


return Response 
.status(Response.Status.CREATED)// 201 
.entity("A new podcast/resource has been created at /de 
* createPodcastid) 
.header("Location", 
"http://1localhost:8888/demo-rest-jersey-spring, 
* String.valueOf(createPodcastid)).bui. 





e QPOST 一 指示 方法 响应 到 HTTP POST 请 求 

e @Consumes({MediaType.APPLICATION_FORM_URLENCODED}) 一 定义 方法 可 
以 接受 的 媒体 类 型 ， 本 例 为 "application/x-www-form-urlencoded" 

e @FormParam 一 这 个 注解 绑 定 的 表单 参数 值 包 含 了 请 求 对 应 资源 方法 参数 的 
实体 。 值 是 URL 的 解码 ， 除 非 禁用 解码 的 注解 。 

e @Produces({MediaType.TEXT_HTML}) 一 定义 方法 产生 的 媒体 类 型 本 例 为 
"text/html" 


响应 
e 成 功 : HTTP 状态 为 201 的 text/html 文件 和 头 的 位 置 指定 的 资源 已 被 创建 


e 错误 : 


o 400 : 没有 足够 的 数据 提供 


o 409 : 冲突 了 。 如 果 在 服务 器 端 被 确定 具有 相同 的 podcast 的 存在 


3.2.2. ii: podcast 


3.2.2.1. 设计 
API 支持 两 种 操作 


e 返回 podcast 的 集合 
e 根据 id 返回 podcast 


注意 到 集合 资源 的 参数 -rderBylnsertionDate 和 numberDaysToLookBack ° Æ URI 
查询 参数 添加 过 滤器 而 不 是 路 径 的 一 部 分 这 个 是 很 有 道理 的 。 


3.2.2.2. 实现 


3.2.2.2.1. 获取 所 有 podcasts (“/”) 


* 


Returns all resources (podcasts) from the database 


@return 

@throws IOException 

@throws JsonMappingException 
@throws JsonGenerationException 
@throws AppException 


+ o OÙ 0k o ok OX 


HA 
QGET 
@Produces({ MediaType.APPLICATION JSON, MediaType.APPLICATION XML ` 
public List«Podcast» getPodcasts( 
QQueryParam("orderByInsertionDate") String orderByInsertior 
QQueryParam("numberDaysToLookBack") Integer numberDaysToLoc 
throws JsonGenerationException, JsonMappingException, IOEx« 
AppException { 
List«Podcast» podcasts - podcastService.getPodcasts( 
orderByInsertionDate, numberDaysToLookBack); 
return podcasts; 





e QGET 一 指示 方法 响应 到 HTTP GET 请 求 

e @Produces({MediaType.APPLICATION_JSON, MediaType.APPLICATION XML 
一 定义 方法 可 以 接受 的 媒体 类 型 ， 本 例 为 "applicatiom/json" 或 者 
"application/xml" (Æ Podcast 类 前 添加 QxmlRootElement ) ， 将 返回 
JSON 或 者 XML 格式 的 podcast 集合 


响应 


e 成 功 : HTTP RA A 200 的 podcast 数据 集合 


3.2.2.2.1. 读 一 个 podcast 
根据 id 获取 一 个 podcast 


QGET 
@Path("{id}") 
@Produces({ MediaType.APPLICATION JSON, MediaType.APPLICATION XML ` 
public Response getPodcastById(QPathParam("id") Long id) 
throws JsonGenerationException, JsonMappingException, IOEx« 
AppException { 
Podcast podcastById - podcastService.getPodcastById(id); 
return Response.status(200).entity(podcastById) 
.header("Access-Control-Allow-Headers", "X-extra-headei 
.allow("OPTIONS").build(); 





e QGET 一 指示 方法 响应 到 HTTP GET 请 求 

e @PathParam("id") - 绑 定 传递 的 参数 值 

e (QProduces((MediaType.APPLICATION JSON, MediaType.APPLICATION XML 
一 定义 方法 可 以 接受 的 媒体 类 型 ， 本 例 为 "applicatiom/json" 或 者 
"application/xml" (Æ Podcast 类 前 添加 QxmlRootElement ) ， 将 返回 
JSON 或 者 XML 格式 的 podcast 集合 


响应 
e 成 功 : HTTP 状态 A 200 的 podcast 
e 错误 : 404 Not found。 如 果 没 有 在 数据 库 中 找到 


3.2.3. 更 新 podcast 


3.2.3.1. 设计 


| Description | URI | HTTP method | HTTP Status response | | --- | --- | --- | --- | | 
更 新 podcast (完全 ) | /podcasts/{id} | PUT | 200 OK | | 更 新 podcast (#8 +) | 
/podcasts/{id} | POST | 200 OK | 


1. 完 全 更 新 — 提供 所 有 的 值 2. 部 分 更 新 一 传递 部 分 属性 值 即 可 
3.2.3.1. 实现 


3.2.3.1.1. 完全 更 新 
创建 或 者 完全 更 新 资源 


@PUT 

@Path("{id}") 

@Consumes({ MediaType.APPLICATION_JSON }) 

@Produces({ MediaType.TEXT_HTML }) 

public Response putPodcastById(QPathParam("id") Long id, Podcast pt 
throws AppException { 


Podcast podcastById = podcastService.verifyPodcastExistenceByI« 


if (podcastById == null) { 
// resource not existent yet, and should be created under 1 
// specified URI 
Long createPodcastId = podcastService.createPodcast(podcas! 
return Response 
. Status(Response.Status.CREATED) 
// 201 
.entity("A new podcast has been created AT THE LOC/ 
.header("Location", 
"http://1localhost:8888/demo-rest-jersey-sp! 
* String.valueOf(createPodcastId)) 
) else £ 
// resource is existent and a full update should occur 
podcastService.updateFullyPodcast(podcast); 
return Response 
.Status(Response.Status.OK) 
// 200 
.entity("The podcast you specified has been fully i 
.header( "Location", 
"http://localhost:8888/demo-rest-jersey-sp! 
* String.valueOf(id)).build(); 





e QPUT 一 指示 方法 响应 到 HTTP PUT 请 求 

e (PathParam("id") - 绑 定 传递 的 参数 值 

e @Consumes({MediaType.APPLICATION_JSON}) 一 定义 方法 可 以 接受 的 媒体 
类 型 ， 本 例 为 "application/json" 

e QProduces((MediaType.TEXT HTML)) 一 定义 方法 可 以 产生 的 媒体 类 型 ， 本 
Ta] A text/html" 


响应 


e 创建 

o 成 功 : HTTP 状态 为 201 Created 

o 错误 : 400 Bad Request。 如 果 需 要 的 属性 值 没 有 提供 
e 完全 更 新 : 

o 成 功 : HTTP 状态 为 200 


o 错误 : 400 Bad Request。 如 果 不 是 所 有 的 属性 都 提供 
3.2.3.1.2. 部 分 更 新 


//PARTIAL update 
QPOST 
@Path("{id}") 
@Consumes({ MediaType.APPLICATION_JSON }) 
@Produces({ MediaType.TEXT_HTML }) 
public Response partialUpdatePodcast(@PathParam("id") Long id, Pod 
podcast.setId(id); 
podcastService.updatePartiallyPodcast(podcast); 
return Response.status(Response.Status.OK)// 200 
.entity("The podcast you specified has been successful. 
.build(); 





e QPOST 一 指示 方法 响应 到 HTTP POST 请 求 

e QPathParam("id") - 绑 定 传递 的 参数 值 

e @Consumes({MediaType.APPLICATION_JSON}) 一 定义 方法 可 以 接受 的 媒体 
类 型 ， 本 例 为 "application/json" 

e QProduces((MediaType.TEXT HTML)) 一 定义 方法 可 以 产生 的 媒体 类 型 ， 本 
#1] 4 t'ext/html" 


响应 
e 成功: HTTP 状态 为 200 OK 
e 错误 : 404 Not Found。 如 果 资源 不 存在 


3.2.4. 删除 podcast 


3.2.4.1. 设计 


| Description | URI | HTTP method | HTTP Status response | | --- | --- | --- | --- | | 
移 除 所 有 podcasts | /podcasts/ | DELETE | 204 No content | | 移 除 特定 位 置 的 
podcast | /podcasts/(id) | DELETE | 204 No content | 

3.2.4.2. 实现 


3.2.4.2.1. 删除 所 有 资源 


QDELETE 
@Produces({ MediaType.TEXT HTML }) 
public Response deletePodcasts() { 
podcastService.deletePodcasts(); 
return Response.status(Response.Status.NO CONTENT)// 204 
.entity("All podcasts have been successfully removed") 








e (DELETE 一 指示 方法 响应 到 HTTP DELETE 请 求 
e QProduces((MediaType.TEXT HTML)) 一 定义 方法 可 以 产生 的 媒体 类 型 ， 本 
#1] ÁJ "text/html" 


响应 


e 返回 html 文档 
3.2.4.2.2. 删除 一 个 资源 


QDELETE 
@Path("{id}") 
@Produces({ MediaType.TEXT_HTML }) 
public Response deletePodcastById(QPathParam("id") Long id) (í 
podcastService.deletePodcastById(id); 
return Response.status(Response.Status.NO CONTENT)// 204 
.entity("Podcast successfully removed from database").l 





e @DELETE 一 指示 方法 响应 到 HTTP DELETE 请 求 

e QPathParam("id") - 绑 定 传递 的 参数 值 

e @Consumes({MediaType.APPLICATION_JSON}) 一 定义 方法 可 以 接受 的 媒体 
类 型 ， 本 例 为 "application/json" 

e @Produces({MediaType.TEXT_HTML}) 一 定义 方法 可 以 产生 的 媒体 类 型 ， 本 
#1] ÁJ "text/html" 


响应 
e 成 功 : HTTP 状态 A 204 No Content 
e 错误 : 404 Not Found。 如 果 资源 不 存在 


4.4% 


Ý JL http://www.codingpedia.org/ama/how-to-log-in-spring-with-slf4j-and-logback/ 


5. H h AL IF 


错误 处 理 要 有 统一 的 格式 ， 就 像 下 面 


{ 
"status": 400, 
"code": 400, 
"message": "Provided data not sufficient for insertion", 
"link": "http://www.codingpedia.org/ama/tutorial-rest-api-desigt 
"developerMessage": "Please verify that the feed is properly ger 
} 


EEE X 





6. 服务 端 添加 CORS 支持 
7. 测试 

7.1. 在 Java 集 成 测试 

7.1.1. 配置 


7.1.1.1 Jersey 客户 端 依赖 


<dependency> 
<groupId>org.glassfish.jersey.core</groupId> 
<artifactIid>jersey-client</artifactId> 
<version>${jersey.version}</version> 
<scope>test</scope> 

</dependency> 


7.1.1.2. Failsafe 插件 


«plugins» 
[...] 
<plugin> 
<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-failsafe-plugin</artifactId> 
<version>2.16</version> 
<executions> 
<execution> 
<id>integration-test</id> 
<goals> 
<goal>integration-test</goal> 
</goals> 
</execution> 
<execution> 
<id>verify</id> 
<goals> 
<goal>verify</goal> 
</goals> 
</execution> 
</executions> 
</plugin> 
[...] 


</plugins> 


7.1.1.2. Jetty Maven 插件 


Fi [psg] 


«plugins» 
«plugin» 
«groupId»org.eclipse.jetty«/groupId» 
«artifactId»jetty-maven-pluginc/artifactlId» 
<version>${jetty.version}</version> 
<configuration> 
<jettyConfig>${project.basedir}/src/main/resources/coni 
<stopKey>STOP</stopKey> 
<stopPort>9999</stopPort> 
<stopWait>5</stopWait> 
<scanIntervalSeconds>5</scanIntervalSeconds> 
[...] 
</configuration> 
<executions> 
<execution> 
<id>start-jetty</id> 
<phase>pre-integration-test</phase> 
<goals> 
«!-- stop any previous instance to free up the 
<goal>stop</goal> 
<goal>run-exploded</goal> 
</goals> 
<configuration> 
<scanIntervalSeconds>0</scanIntervalSeconds> 
<daemon>true</daemon> 
</configuration> 
</execution> 
<execution> 
<id>stop-jetty</id> 
<phase>post-integration-test</phase> 
<goals> 
<goal>stop</goal> 
</goals> 
</execution> 
</executions> 
</plugin> 
[...] 


</plugins> 





详细 配置 见 源码 中 的 pom.xml 


7.1.2. 编译 集成 测试 
使 用 JUnit 作为 测试 框架 。 默 认 的 Failsafe 插件 自动 包含 所 有 测试 类 


e" */IT .java "一 “lIT” 开 头 的 文件 . 
e" */ IT.java "一 “IT” 结 尾 的 文件 . 


e" */ ITCase.java "一 “|TCase” 结 尾 的 文件 . 


创建 了 测试 类 RestDemoServicelT 


public class RestDemoServiceIT { 


[RES 

@Test 

public void testGetPodcast() throws JsonGenerationException, 
JsonMappingException, IOException { 


] 


ClientConfig clientConfig = new ClientConfig(); 
clientConfig.register(JacksonFeature.class); 


Client client - ClientBuilder.newClient(clientConfig); 


WebTarget webTarget - client 
.target("http://localhost:8888/demo-rest-jersey-spi 


Builder request = webTarget.request(MediaType.APPLICATION . 


Response response = request.get(); 
Assert.assertTrue(response.getStatus() == 200); 


Podcast podcast = response.readEntity(Podcast.class); 


ObjectMapper mapper = new ObjectMapper(); 
System.out 
.print("Received podcast from database ***********: 
* mapper.writerWithDefaultPrettyPrinter() 
.WwriteValueAsString(podcast)); 





e 在 客户 也 要 注册 JacksonFeature ， 这 样 才能 解析 JSON 格 式 
e 用 jetty 测试 ， 端 口 8888 

e HZ 返回 200 状态 给 我 们 的 请 求 

e org.codehaus.jackson.map.ObjectMapper 帮助 返回 格式 化 的 JSON 


mvn verify 


设置 jetty.port 属性 到 8888,Eclipse 配置 如 下 


7.2. 用 SoapUl 集成 测试 


youtube 视 频 教程 ( Fas ) 


8. 版 本 管理 


几 个 要 点 : 

e URL: “/vi/podcasts/{id}” 

e Accept/Content-type header: application/json; version=1 
在 路 径 中 加 入 版 本 信息 

QComponent 


QPath("/vi1/podcasts") 
public class PodcastResource {...} 


+ 


考 : 


e https://jersey.java.net/ 

e https://github.com/waylau/Jersey-2.x-User-Guide 

e http://www.codingpedia.org/ama/tutorial-rest-api-design-and-implementation- 
in-java-with-jersey-and-spring/ 


